home *** CD-ROM | disk | FTP | other *** search
/ Shareware Super Platinum 8 / Shareware Super Platinum 8.iso / mac / DATABASE / BORUSR2.ZIP;1 / README.TXT < prev    next >
Encoding:
Text File  |  1992-10-07  |  17.8 KB  |  370 lines
  1. *==============================================================================*
  2. *                           BORLAND BBS USERS LIST SYSTEM                      *
  3. *                                   Release 2                                  *
  4. *                                   07/05/92                                   *
  5. *                                   Ken Mayer                                  *
  6. *==============================================================================*
  7.  
  8. This system was designed as a front-end to the database created by Tony Lima
  9. to track the frequent users of the Ashton-Tate/Borland BBS. 
  10.  
  11. I tried to make it as flexible as possible for various systems. Below are a few
  12. notes you may want to look over before starting this up:
  13.  
  14. ==========================
  15. GENERAL STUFF/INSTALLATION
  16. ==========================
  17.  
  18. Easiest method to install is to create a directory on the hard drive (something
  19. like BORUSER makes sense, i.e., MD \BORUSER), and issue the command:
  20.  
  21. PKUNZIP BORUSR2 C:\BORUSER
  22.  
  23. This will unzip the whole system into the directory specified (in the example 
  24. above, to C:\BORUSER).
  25.  
  26. This system assumes that 1) you're on a hard drive, with these files in a 
  27. directory (the programs aren't looking for a specific one), and 2) that dBASE
  28. is in your DOS PATH. 
  29.  
  30. The first time, call dBASE to get to the dBASE dot prompt.
  31.  
  32. From there, type: 
  33.  
  34. DO COMPILE
  35.  
  36. To compile all the programs ... or:
  37.  
  38. DO PRINT
  39.  
  40. To get a printout of all the programs, documentation, etc. Note that the print 
  41. program actually asks if you want to print the procedure files, the picklist 
  42. file, and/or the documentation. That's because these take a LOT of paper.
  43.  
  44. You can start the system up by typing: 
  45.  
  46. DO MENU
  47.  
  48. at any time after that from the dot prompt.
  49.  
  50. ------------------
  51. AFTER INSTALLATION
  52. ------------------
  53. To start the system up AFTER the first time, at the DOS prompt (if you're in
  54. this directory), type:
  55.  
  56. D
  57.  
  58. and press the <Enter> key. This will load dBASE with the /T parameter, and
  59. call the MENU program.
  60.  
  61.  
  62. ====================
  63. COLOR vs. MONOCHROME
  64. ====================
  65. The system is designed so that the first time you call the menu, it 
  66. checks your monitor chard -- if the card is a monochrome only card (IBM and
  67. early clones -- no graphics ability) the system simply sets colors for you -
  68. otherwise, it asks if you have color. Either way, a memory file is written to 
  69. the directory you loaded this into, called COLOR.MEM. It contains the color 
  70. definitions used by the programs. If you make a mistake (telling the system you
  71. have color and you don't, or vice-versa) you can fix it easily, by using the 
  72. QUIT TO DBASE option from the menu, and typing "!DEL COLOR.MEM" (or, if using 
  73. from RUNTIME, from DOS simply type "DEL COLOR.MEM"). When you run the program 
  74. again ("DO MENU"), the program will note that the COLOR.MEM file doesn't exist,
  75. and ask again.
  76.  
  77. Some of my beta testers have tried the color options on a monochrome monitor, 
  78. and claim that everything works (is readable). I haven't been able to try it
  79. on a completely monochrome system. If you have problems, please let me know. 
  80.  
  81. ====
  82. VGA?
  83. ====
  84. The system makes use (as of 12/12/1991) of the programs (by George E. McMullen,
  85. Borland Technical Support) SETCLR.PRG, CDEFAULT.PRG and COLORCTL.ZIP for
  86. VGA monitors, to modify the colors, allowing some personalization. 
  87. To change them, choose the CONFIGURATION option from the menu (and follow the
  88. prompts) or, at the DOT prompt, type:  DO SETCLR.  Once you do that, the MENU 
  89. system will automatically load the colors you have chosen ... (well, to a point 
  90. -- it defaults to using certain colors for things ...). The system asks if you 
  91. have VGA -- if you do, it will rename a file to a dBASE memory file, otherwise 
  92. it will be left alone, and the system will not re-define the colors you are 
  93. using. To handle this automatically, delete the COLOR.MEM file, so that the
  94. menu forces you to deal with the color (yes/no) situation mentioned above.
  95. For more information on how these work, see the file: COLORCTL.TXT.
  96.  
  97. ========
  98. PRINTERS
  99. ========
  100. NEW TO RELEASE 2 -- there is a configuration program you can call from the menu
  101. that will allow you to setup your printers. As a matter of fact, the first time
  102. you call the menu, if you have not run the printer configuration routines,
  103. you will be "forced" into them. This will allow you to setup two printers,
  104. if you desire. Suggest you use ASCII.PR2 as the second printer if you do not
  105. have a second physical printer. It can be useful for sending output to disk.
  106.  
  107. Known Problem -- use of the 'GENERIC' default printer driver with a LaserJet 
  108. printer may cause a page-eject between each record, reason: UNKNOWN ...
  109.  
  110. =======
  111. MOUSIES
  112. =======
  113. NEW TO RELEASE 2 -- using Jay Parsons' JPMOUSE.BIN, and a couple of 
  114. functions designed to use the bin file, on some machines, using dBASE IV,
  115. 1.5, you may turn the mouse on and off by pressing <Alt><M>. This should
  116. toggle the mouse. I have gotten reports from my beta testers that this does
  117. not always work, however: it DOES work on my Microsoft mouse that I use at
  118. home, and the LogiTech mouse that I use at work. Other than that, no 
  119. guarantees. Jay (JPARSONS) and Zak (HAZMATZAK) are working on finding the
  120. definitive mouse routines ... in the meantime, this is what we gots.
  121. What I have done is set the system to hide the mouse cursor -- it's actually
  122. still active. Sorry 'bout that. The toggle command will hide/unhide the
  123. cursor, but the mouse IS still active, either way. I found the cursor
  124. distracting, and since my LogiTech mouse won't deactivate with Jay's routine,
  125. but DOES let me hide it ... (Jay says he's attempting to get info from
  126. LogiTech to see if they will provide the info he needs ...)
  127.  
  128. ==============================================
  129. TO GET THE MOST UP-TO-DATE VERSION OF THE DATA
  130. ==============================================
  131. Tony Lima has been kind enough to enter the data, and is trying to keep it
  132. current. If you want the most current version of the data file (and MDX)
  133. download from the BORLAND BBS (BORBBS) the file:  BORUSDBx.ZIP. 
  134.   Where 'X' in the file name is a numeric value ...
  135.  
  136. ==============================
  137. TO BE INCLUDED IN THE DATABASE
  138. ==============================
  139. Don't find your name in the database? Feel like you've been left out? Want to 
  140. be part of the 'in-crowd'? <g> Leave an EMAIL message for TONYLIMA on the
  141. BORBBS, and he will add your name to the database. Next time he uploads the
  142. file BORUSDBx.ZIP to the BORBBS, you'll be there as well as all those other
  143. noteworthys ... 
  144.  
  145. ================================================================================
  146.                             MENU OPTIONS DESCRIPTION
  147. ================================================================================
  148.  
  149. Enter Data
  150. ----------
  151. Pretty obvious, for the most part. There's not much error checking. If you try 
  152. to save a blank record (or move to the second screen of a blank record) the 
  153. system will bring up a dialog box, noting the record is blank. It asks if you
  154. wish this to be so, and if so, will exit the entry routine, deleting the blank
  155. record. The rest of the routine is pretty obvious. When you exit, it's designed
  156. to automatically deal with blank records (no data in the BORBBS_ID and the 
  157. LAST_NAME fields). NOTE the BIO field -- this is a memo. It acts like a memo.
  158. Instructions for the BIO field are at the bottom of the screen.
  159.  
  160. Edit Data
  161. ---------
  162. I'm kinda proud of this one. When you bring it up, it asks if you want to search
  163. by the BBSID, by last name, or by state. If you choose BBSID or Last Name, 
  164. it will ask for as much as you can remember (if you know the BBSID starts with
  165. the letter 'S' but can't remember the rest ... it'll work). If a match is found,
  166. the system brings up the first record to match. If there's more and the first
  167. isn't the one you wanted, it'll bring up the next, until you find who you're
  168. looking for, or there are no more records that match. The rest is 
  169. straightforward. 
  170.  
  171. IF you ask for a search by STATE -- if there's only one person who lives/works
  172. in a specific state, the system will bring up a partial record and ask if 
  173. that's who you wanted (if not, you return to the mini-menu ...). If there's 
  174. more than one person in that state, the system brings up a picklist showing 
  175. BORBBS_ID, FIRST_NAME, LAST_NAME and CITY ... pressing <Esc> will exit and 
  176. return to the menu. Pressing <Enter> will bring up that record.
  177.  
  178. NOTE: For users who have played with version 1 -- the delete routine has been
  179. included in the EDIT routine above. Pressing <Alt>D will DELETE the record,
  180. pressing it again will RECALL it. 
  181.  
  182. Also note the BIO field. Note when the cursor is ON that field, that you may 
  183. either edit the memo (<Ctrl><Home>) or View it (<F2>). When editing, the editor
  184. menus are accessible, although not obvious ... The 'View' option uses Martin 
  185. Leon's MEMOPAGR routine.
  186.  
  187. Print Report
  188. ------------
  189. This simply prints a listing of any/all data in the database for a user.
  190. If the user has given us a business address but no home address, the home
  191. information won't print and vice-versa. No blank lines for empty data ...
  192. It will print any/all electronic mail service ids that we have data on. 
  193. Took me a long time to get this to work. Take a look ... please note that
  194. due to all the checking of data (mentioned above), this report takes longer
  195. than one might expect (unless you're using dBASE IV, 1.5, in which case
  196. the report is much faster than one might expect). Give it a chance ...
  197.  
  198. UPDATE TO PRINT REPORT --
  199. I have added 
  200. 1) two sorts for listing the data -- sorted by LASTNAME or by Borland BBS ID,
  201. 2) an optional filter to list only those who live in a specific state, or
  202.    those with either a fax or BBS.
  203. 3) Printer selection ... you can send the report to
  204.    a) one of two printers
  205.    b) the screen
  206.    c) a file called REPORT.TXT (ASCII file format) (or your own file)
  207. 4) Printing the memo field: BIO. If you send output to the screen and there
  208.    is data in the BIO field, you should get simply a note on the screen at
  209.    the end of the record. If you send output to a file or printer, you should
  210.    get the contents printed. If the memo would print beyond the end of page,
  211.    you SHOULD get the memo split onto a new page, with a header displaying
  212.    who's BIO you are getting.
  213.  
  214. I also made it possible to exit by pressing <Esc> from all the above options,
  215. and I BELIEVE it works. If it blows up, please let me know. 
  216.  
  217. Configuration
  218. -------------
  219. This allows you to change the color setup for your machine, as well as to
  220. change your printer configuration. It (hopefully) is fairly straight-forward.
  221.  
  222. The color configuration allows you to change from:
  223.    COLOR TO MONO
  224.    MONO TO COLOR
  225.    COLOR TO VGA
  226.    VGA TO COLOR
  227.    MONO TO VGA
  228.    VGA TO MONO
  229.  
  230. ('COLOR' in the above list refers to CGA/EGA systems ...)
  231.  
  232. It also allows users of VGA systems to change the COLOR VALUES of the VGA
  233. monitor, so that you can modify how, for example, CYAN looks by adding more
  234. blue to it, or more yellow ... You can use all 256 shades of a color by
  235. experimenting with the 'guns'.
  236.  
  237. At this time I haven't found a good way to show how the colors you set here
  238. will affect the colors in the program. The basic breakdown is that I am 
  239. using mostly fairly standard colors. The main backgrounds are dark blue, with
  240. bright white text (W+/B). Menus and most of the popups are cyan with yellow 
  241. text (RG+/GB). Errors and some warnings are yellow on red (RG+/R). That's 
  242. most (if not all) the colors I really use ... I wasn't being TOO fancy.
  243.  
  244. When you change color mode (MONO TO COLOR, etc), you will have to quit to the
  245. DOT prompt and restart to see the changes properly ... did the best I could.
  246.  
  247. If you use the program to modify your color values, read the screen ... unless
  248. you save your changes, they will be lost. (See COLORCTL.TXT for more details.)
  249.  
  250. QUIT
  251. ----
  252. Drops you out to the DOS prompt (D.BAT if you wanna get technical), closing 
  253. everything down (and returning you to DOS, Windows, OS/2, DesqView or wherever
  254. you called it from ...).
  255.  
  256. Exit to dBASE
  257. -------------
  258. Drops you to the DOT prompt of dBASE. This will give you a chance to do such
  259. things as look at or print the programs, use BROWSE if you want, go to the
  260. control center, bypassing all this work >sniff<, run SETCLR, and so on. If you
  261. are running this via RUNTIME, this option should not appear in the menu.
  262.  
  263. ================================================================================
  264.                             FILES INCLUDED HERE
  265. ================================================================================
  266. README.TXT   -- This file -- a description of the system
  267.  
  268. ATUSERS.DBF  -- The database
  269. ATUSERS.MDX  -- Production index file for above
  270. ATUSERS.DBT  -- The MEMO file.
  271.  
  272. MENU.PRG     -- The menu program
  273.                 Information about the MDX tags is stored in here ...
  274. BORENTR.PRG  -- Data Entry program
  275. BOREDIT.PRG  -- Data EDIT/Search program
  276. BORREP.PRG   -- Print/display/write-to-file the data
  277.  
  278. CONFIG.PRG   -- Configuration routine. It handles all the color/monochrome
  279.                 settings (but will call SETCLR.PRG). It will also call
  280.                 the printer configuration program (PCONFIG.PRG).
  281.  
  282. COLOR.MEM    -- This file will be created the first time you run the menus,
  283.                 it stores the settings for the color memory variables.
  284. COLORCTL.TXT -- Description of the next couple of items ...
  285. SETCLR.PRG   -- New program (George E. McMullen, Borland) to play with
  286.                 VGA colors ... access is from the CONFIGURE option of the
  287.                 menu.
  288. CDEFAULT.PRG -- Loads colors set with SETCLR.PRG ...
  289. COLORCTL.BIN -- BIN file used with SETCLR and CDEFAULT programs.
  290. CLRDESC.FIL  -- IF you tell the menu system the first time you load that you
  291.                 have VGA, this file gets renamed to: CLRDESC.MEM. Otherwise
  292.                 it stays this way, and is ignored. File loaded/modified by 
  293.                 SETCLR and CDEFAULT programs above.
  294. CLRDESC.MEM  -- This file will be created the first time you run the menus,
  295.                 if you are using a VGA monitor, or if you reset the color
  296.                 values for the VGA. (See CDEFAULT and SETCLR 
  297.                 programs.)
  298. CLRDESC.DEF  -- Default settings for VGA colors.
  299.  
  300. PCONFIG.PRG  -- Based on Bowen Moursund's routines. Heavily modified.
  301. PDRIVERS.DBF -- Printer driver database.
  302. PDRIVERS.MDX -- Production MDX for PDRIVERS.DBF
  303. DRIVERS.EXE  -- This is the zipped file that comes with dBASE IV, containing
  304.                 all printer drivers ... (except for addins -- haven't quite
  305.                 figured out how to deal with those, yet).
  306. PRINTER.MEM  -- This file is created by the PCONFIG.PRG, and shouldn't actually
  307.                 exist until you run the menu the first time (which will force
  308.                 you to run the PCONFIG program).
  309.  
  310. PROC.PRG     -- Procedure file -- this is a subset of what the file PROC.PRG
  311.                 from the LIB17 version of the function/procedure library on
  312.                 the BORBBS.
  313.                 For the most up-to-date version, check the BORBBS for
  314.                 LIBxx.ZIP (in the DB415 library).
  315.  
  316. PICKLIST.PRG -- Picklist procedure (Martin Leon, HMan of the BOR-BBS)
  317. PRINT.PRG    -- Program to print the rest of the programs ... <grin>
  318.                 Don't use unless you've set printer information either
  319.                 in your CONFIG.DB or in PROC.PRG (SETPRINT procedure).
  320. COMPILE.PRG  -- A simple program designed to quickly compile the rest
  321.                 of the programs. 
  322.  
  323. D.BAT        -- DOS Batch file assumes you're in the appropriate directory for
  324.                 this system, will load dBASE with /T and MENU ... nice and
  325.                 simple ...
  326. JPMOUSE.BIN  -- This is Jay Parson's mouse BIN file. 
  327.  
  328.         (These two files are here for Panasonic KX-P1124 users ... drivers I 
  329.         got from the BBS, not included in the Borland Drivers file ...)
  330. KX_PCA_1.PR2 -- a bit faster than the other, but line draw and upper ascii
  331.                 characters aren't done well ...
  332. KX_PCA_2.PR2 -- this one handles line-draw characters better than the other.
  333.  
  334. (after compiling programs, there will be DBO files to match the PRG files ...
  335. these should be there ... honest!)
  336.  
  337. ================================================================================
  338.                      CREDIT WHERE CREDIT IS DUE, Department
  339. ================================================================================
  340. Being one who believes in giving the appropriate credit, I want to thank all
  341. twelve of my beta testers: Joey D. Carroll (JOEY), Keith G. Chuvala (KGC), 
  342. xxx (CORNER),  David W. Love (DAVIDLOVE), Lee Hite (BOSEPHUS),
  343. Charlie Lutz (LUTZM), Jim Garrett (GARRETT), Edward N. Todd (EDTODD), 
  344. Dave Laird (COMPCON), Doug Willis (ICU812), David L. Creek (DCREEK), and 
  345. Dave Krajcar (ALTSOL).
  346.  
  347. Without these brave souls, dealing with at least 8 beta versions of this
  348. software, testing things, giving me LOOONG error report listings, and in
  349. some cases, giving me some actual code examples to show me how to cope with
  350. something (or give me ideas on how to cope ...), this wouldn't work so well.
  351.  
  352. Tony Lima (TONYLIMA) who attempts to keep the database up-to-date should be 
  353. thanked as well.
  354.  
  355. Jay Parsons (JPARSONS) and Bowen Moursund (BOWEN) have given me many ideas
  356. and lots of help (and the mouse bin file), although they weren't part of the 
  357. beta test ...
  358.  
  359. Finally, without Borland's BBS, I couldn't have gotten to where I am with my
  360. programming abilities in dBASE ... 
  361.  
  362. ================================================================================
  363.                                     NOTICE
  364.  
  365. These files are placed into the public domain, by Kenneth J. Mayer and Tony
  366. Lima, this July, 1992. Enjoy.
  367. ================================================================================
  368.  
  369. End of File: README.TXT
  370.